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THE COMPLEAT GUIDE TO LOCKSMITH PARAMETERS 

This document describes all user-changeable LOCKSMITH parameters in depth. A partial list of 
these parameters was previously distributed to all Version 4.0/4.1 owners. Also provided here 
is detailed LOCKSMITH program logic information. 

Note This document is of a highly technical nature, and is intended primarily for the 

ADVANCED user of LOCKSMITH. 

BACKGROUND 



When LOCKSMITH was first introduced in January 1981, it would copy almost all disks with 
no special instructions from the user. Only a few disks required parameter changes. 

Alas, those good old days are gone forever Instead of providing the user with better 
backup policy, software vendors decided to escalate the battle by developing more complicated 
(and in some cases, biiarre) protection techniques. Because of the many different techniques 
now in use, it is likely that many disks will require some input from the user in the form of 
parameter changes. Omega Microware currently maintains an eitensive list of software, along 
with the LOCKSMITH parameters used to copy each Some of the entries on this list are 
us e r - supp 1 i ed , and Omega Microware welcomes information from users regarding how to back-up 
software not already on this list 

OVERVIEW 



LOCKSMITH copies disks by reading a track, performing ana lysis on the data, and writing 
t he track back to the copy disk. 

Reading and writing are f a i r 1 y straightforward functions. The analysis of the track data 
is by far the mo s t difficult task, and must provide for fleiibility. 

Many analysis routines < a 1 g o r i t hms ) are provided wi thin LOCKSMITH Each a 1 g o r i t hm 
performs a specific f unc t ion relating to the analysis of track data. 

By Chang i ng parameters, the user may select , disable, or change the eiecution order of 
a 1 g r i t hms . Parameters may also be used to define values to be used by individual algorithms. 

ALGORITHMS 



The a 1 g r i t hms are numbe red from to $23 Call values are in hex), a 1 though more 
a 1 go r i t hms may be added in future versions of LOCKSMITH . During track analysis , algorithms 
are selected sequentially from a table of algorithm numbers, located from PARM4C-80 . As 
algorithms are selected from this table during analysis, they are displayed on the screen as 
2-digit hex numbers in inverse video. A 1 g o r i t hm 00 indicates a null a 1 go r i t hm , which can bt 
used to replace a 1 go r i t hm numbers in the table which the user wants to disable. An FF entry in 
this table indicates the end of the algorithms to perform 

Currently, the algorithm table contains four separate algorithm sequences, each one 
terminate d by an FF ent ry . The s t ar t in g p o i n t of the algorithm sequence to be used is defined 
by PARM2T Th i s pa r ame t e r contains the indsH into the algorithm table to be used as the first 
algorithm of a sequence. For eiampie, if FARM25=00, the algorithm sequence would start at 
PARM4C. I f PARM25=10, the algorithm sequence would start at PARM5C. 

The section of a 1 go r i thm table starting at FARM71 is selected as an algorithm sequence 
start ( ins t ead of PARM4C ) when synchr oni led tracks are chosen . 

Algorithms, in addition to performing their specialiEed function, can return a flag to 
indicate success or f ai lure . I t is possible to indicate tha t an a 1 go r i thm is to be performed 
only if the previous algorithm failed. This may be done by setting the high-order bit of the 
algorithm number within the algorithm table. For eKample, an entry of Al indicates that 
algorithm 21 is to be performed on 1 y if the previous algorithm failed. 

DESCRIPTION OF ALGORITHMS 

The f 1 1 owi ng is a list of algorithm numbe r s and the par ame t e r s which affect them. 

ALG 00 (this algorithm doesn't do much of any thing) 

ALG 01 ( conse cu t i ve nibbles to self-sync) changes no rma 1 nibbles to self-sync nibbles based 
on: f ind ing (PARMIO) consecut i ve nibbles in the range ( PARM34 ) to ( PARM35 ) , inclusive. For 

example, if PARMlOsOC, PARM34sFE, and PARM35 = FF, then algor i thm 01 would search for sequences 
of length OC nibbles with values FE through FF , and set them to self-sync. 



ALG 02 (invalids to self-sync) 

sets invalid nibbles (those with 3 or more consecutive ftro bits) to self-sync 



ALG 03 ^standardiie sflf-sync) 
sets all 5elf-?yTic to (PARM33) 



which must have high-ordtr bit cltar 



ALG 04 (loner self-sync to normal) 

set consecutive self-sync strings of less than or equal to (PARM3C) to normal 

ALG 05 (glitch r emo v e r ) 

set consecutive normal nibbles of length less than or equal to (PARM12) to self-sync 
ALG 06 (set self-sync by marker pattern match) 

searches for pattern specified by (FARM 44-41), and sets the previous (FARM 40) nibbles to 
self-sync Values of 00 within the pattern are "don't care" and always match. 

ALG 07 (eKtend bit shifted self-sync) 

tKtends self-sync strings backwards, using the table at (PARM86-A5) This table contains 
nibble value sequences frequently found to be self-sync. 

ALG 08 (reserved for future use) 

ALG 09 (trackstart after longest gap) 

set trackstart to first normal after longest string of self-sync (gap) 
ALG OA (minimum length self-sync) 

eRtend self-sync strings backwards to minimum length of <PARM2C). 



ALG OB (set self-sync by self-sync pattern match) set self-sync leased on multiple-byte pattern 
aatch Pattern is defined at (FARM81-85) and is tern^inated with a 00 value 

ALG OC ^shorten all gaps) 

shorten all gaps (consecutive strings of self-sync) by (FARM41) nibbles if the string length 
was greater than or equal to (PARM16). 

ALG OD (2 of 3 gap merge ) 

merges first and second gaps (by setting to self-sync, nibbles between them) if 3 gaps are 

(The gaps merged are usually the gap after a data field.) 
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future use) 
ALG 17 (track-end and compare) 

This algorithm searches for a repeat of the track-start beginning at (PARMID) pages beyond the 
current track-start A repeat of the track-start is determined by matching (FARMIE) number of 
nibbles If the track size is greater than (PARMIB) pages, an error 2 status code will be 

issued Once a track-end is chosen, the first two track images are compared, nibble for 
nibble If an unequal nibble compare occurs, a look-ahead of up to (FARM13) nibbles is 
performed, looking for self-sync If self-sync %$ found, the compare failure is ignored. If 
no self-sync is found during this look-ahead, a counter is incremented for the 
compare-failure, and this count is checked against (PARM14), which must not be exceeded, or an 
error 4 status code is issued immediately. The 3rd track image is then used as a tie-breaker 
to determine which of the Ist or 2nd track images is correct. The exact position in the 3rd 
track image is found by first finding the approximate location in the 3rd image (by using 
track length), backing up (PARMll) nibbles, and pattern-matching (PARM32) number of nibbles, 
while searching through the next (PARM31) number of nibbles. The Ist image is corrected by the 
tie-breaker nibble This algorithm returns a 
success/ f a i 1 flag 



These slgorithms are used to dynamically modify parms The table at (PARMB6-D8) consists of 
several sequences of parm modifier entries Each parm modifier entry consists of ^ pair of 
bytes The Ist byte defines the parm number, and the 2nd byte defines the new parm value 

The end of a sequence is indicated by a 00 entry for parm number, and a new sequence begins 
with the neKt byte Algorithm 18 invokes the 1st sequence of parameter modifier entries, 
algorithm 19 invokes the 2nd sequence, etc U<;inq these algorithms, parameters may be 

automatically changed and restored during analysis The defaults for these algorithms are 
currently set as follows: 

ALG18 sets IS-sector parms 

ALG19 sets Id-sector parms 

ALGIA sets misc. parms 

ALGIB sets n i b b 1 e - co un t i ng parms 



ALG 2 (goto nibble buffer address) 

This algorithm is used in conjunction with the nibble editor. This algorithm 
for an address to go to, and the nibble editor cursor is immediately placed at 
(see INVOKING ALGORITHMS FROM THE NIBBLE EDITOR) 



p r omp t s t hf user 
that location 



ALG 2 1 (set error code t ) 

issues an error 1 status code It is usually placed in the algorithm table with the 

high-order bit set. to cause it to execute only when the previous algorithm fails. 

ALG 22 (backup trackstart to front of gap) 

moves the trackstart pointer backwards to the beginning of the preceeding gap 



-ALG 2-1- 



sets trackstart to the 1st nibble of the longest sequence of normal nibbles 

PRINTER CONTROL PARMS 



(FARM2D) specifies the printer slot, and (PARM2E) is set to 00 if LOCKSMITH is not to generate 
<CR) at the end of a line, or left at 01 if <CR)'s are to be generated. 

MAXIMUM ERROR COUNT PARMS 



(PARMOl ) , (PARM02 ) . and 
codes 1,2, and 4 in 

(PARM09> , (PARMOA) , and (PARMOC) are used instead 



(PARM04) are used to specify the number of errors allowed for error 
automatic error retry mode. If increments of 1/2 tracks are used. 



NIBBLE-COUNTING PARMS 

There are 3 parameters which are used when nibble-count preservation i s (^es i r td . 3e t t ing 
(PARM36) to 01 turns on ni fcb I e- count i ng . The nibble-count tolerance value, ( PARM3 7 ) , spe ci f i es 
how close to the original disk, the copy must be When n i b b 1 e - c o un t i no , the t r a ck - end p oin t e r 
is moved up by (PARME9) pages before writing 

PARMS USED FOR SYNCHRONIZING 



(PARM22) specifies the track*2 to sync to. This is normally 00, but may be set to any track. 
(PARMIF) is the length of the nibble sequence to sync with, and <PARMA6-B5) contain the 
pattern to match when attempting to sync on the sync-track. Values of 00 within the pattern 
are "don't care" and always match. (PARM23) and (PARM24) are values which can be used to 
adjust the accuracy of the sync-track routine. They are normally equal, and can be adjusted 
by increasing the value of one with respect to the other. 



PARM«^ UC^Fn Tn rOliXRDL WRITING 



<PARM20) contains the lead-in self-sync nibble value (PARM2F-30) (default is $1A00) number 
of these lead-in self sync nibbles are written before track data is written, with the 
exception of synchronized track writing, which is preceeded by (PARM23) lead-in self-sync 
nibbles. The number of framing bits <l or 2) is contained in <PARM21). This places the proper 
number of trailing zero-bits after self sync (PARM2B) contains the number of the algorithm 
to be used to shorten the track after an over-write is detected by verify readback failure. 



(PARM38) is the 
shows the hi-res 
<PARM3A) is used 
(PARM3B), when 
ana lysis. 



OTHER PARMS 

number of nibbles to test during verify readback. (PARM39), if set non-iero, 
screen during analysis, to provide a graphical representation of analysis, 
during disk certify. It specifies the maximum size of the track-end gUtch. 
set to 01, causes the nibble-editor to be entered for every track, before 



DEBUG PARAMETER 



(PARMOO) is a sp e c i a I pa r ame t e r intended for use during LOCKSMITH debugging. 
When this parm is set to 11, certain debugginq options are enabled. They are: 

1. Inspector entry is allowed even with no resident RVTS 

2. Nibble-editor is entered without 

prompting the user for track to read. This allows the previous track to be examined 

3. Invoking algorithms from the nibble-editor, 
(see neKt section) 



INVOKING ALGORITHMS FROM NIBBLE-EDITOR 



With DEBUG parm set (PARM00 = 11), the nibble-editor is sensitive to two a d d i t ; o na 1 c omma nd § 
These are cent r-^>l-&- and controI-A Cpntrol^-S invokes LOCKSMITH t r a c k t ana I y s i s for the track 
currently in the nibble buffer Gontrol^A- first allows th^ u^tr to change parameters by 
entering thf parameter mo<Jifier, and after the user ha^ indicated the fnd of parameter changes 
with a (CR) , it prompts the user for algorithm number. The user-entered algorithm number is 
eR ecu ted immediately, and control is returned to the nibble-editor. In this way. the user can 
dynamically test the effects of specific LOCKSMITH algorithm sequences when attempting to copy 
unknown disks Algorithm 00 can be specified if no processing is to be done. Algorithm 20 is 
very useful within the nibble editor to rapidly go to a specific address wi thi n the nibble 
buffer . 

FARMS AND THEIR DEFAULTS 



The following list ^hows the current default values for parameters of LOCKSMITH version 4 1: 
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